home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 2 / Atari Mega Archive CD - Volume 2.iso / 8bit / cislib_a / extbas.doc < prev    next >
Text File  |  1995-04-22  |  11KB  |  418 lines
  1.  
  2.  
  3.  
  4.    PART I. INTRODUCTION
  5.         EXTENDED BASIC is  a programmer's aid  package which adds  12 useful
  6.    commands to BASIC. The commands are Direct Mode  commands and function as
  7.    if they  were included  within  the BASIC  Cartridge themselves.  Various
  8.    types of commands are DOS related, editing and reference.
  9.    
  10.    SYSTEM REQUIREMENTS
  11.    ATARI 400/800
  12.      32K Ram
  13.      ATARI 810 Disk Drive or Equivalent
  14.      ATARI BASIC Language Cartridge
  15.    Optional Accessories
  16.      System Printer
  17.    
  18.    LOADING EXTENDED BASIC.
  19.    
  20.    1. Turn the computer off.
  21.    2. Insert the Basic Cartridge in the left slot.
  22.    3. Turn on your disk drive.
  23.    4. When the BUSY light goes out, open  the disk drive door and insert the
  24.    EXTENDED BASIC diskette  with the  label in the  lower right-hand  corner
  25.    nearest you. (use disk drive one if you have more than one drive.)
  26.    5. Turn on your computer and your TV set. The program will load in memory
  27.    and start automatically.
  28.    
  29.    6. After the system boots the top line on the screen should say:
  30.    
  31.    Extended Basic 1.0
  32.    
  33.    You may now edit and run Basic programs normally.
  34.    
  35.    PART II. USING EXTENDED BASIC
  36.    
  37.    CORRECT METHOD OF INPUT.
  38.    
  39.         All Extended Basic commands must be entered in Direct Mode and there
  40.    can be only one command per line.
  41.    EXAMPLE: 1) DELETE 10,100
  42.             2) DELETE 10,100:LIST 10,100
  43.             3) LIST 10,100:DELETE 10,100
  44.    
  45.         The correct method of entering the command is  Example 1. In example
  46.    2 the  DELETE command  will  be executed  but the  LIST  command will  be
  47.    ignored. In  example  3 Basic  will  return a  syntax  error and  neither
  48.    command will be executed.
  49.    
  50.    COMMANDS
  51.    
  52.    The following commands comprise the Extended Basic program:
  53.    
  54.    EDITING    DOS UTILITIES  REFERENCE  CONTROL
  55.    RENUMBER   DIRECTORY      QREF         @D
  56.    DELETE     LOCK           XREF         @E
  57.    REPLACE    UNLOCK         SIZE         @X
  58.    MARGIN     RENAME
  59.               ERASE
  60.    
  61.    EDITING IN EXTENDED BASIC.
  62.         All direct  mode input  to  BASIC is  converted from  lower-case  to
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.    upper-case and inverse to normal. The only text  that is not converted is
  71.    the text within double quotes.
  72.    
  73.    PART III. EDITING COMMANDS
  74.    
  75.    RENUMBER
  76.    
  77.         The Renumber command takes the program text in  memory and renumbers
  78.    it according to the parameters  entered with the command. Extended  Basic
  79.    will renumber the program even if the program contains variable branching
  80.    and unreferenced line numbers.  Variable branching and unreferenced  line
  81.    numbers are displayed during the renumber process.
  82.    
  83.    FORMAT: RENUMBER [strt][,new][,inc][,output]
  84.    Short hand for RENUMBER is REN.
  85.    
  86.    PARAMETER  EXPLANATION
  87.    strt       Starting line number, the default is the first line of
  88.               the program.
  89.    
  90.    new        New line number, the default is the starting line number.
  91.    
  92.    inc        Increment between line numbers, the default is 10.
  93.    
  94.    output     Device which the error flags will be printed, valid
  95.               output devices are E:,S:,P:. The default is E:
  96.    
  97.    EXAMPLES:
  98.    RENUMBER 10,,20,"P:"
  99.         The program will be renumbered starting at 10 with increments of 20,
  100.    the error flags will go the the system printer.
  101.    
  102.    REN.,,5
  103.         If the first program line was 100 then the program will be renumbers
  104.    starting at 100  with increments  of 5, the  error flags  will go to  the
  105.    screen.
  106.    
  107.    RENUM.,1000,,"E:"
  108.         the program will now start at 1000 with  increments of 10, the error
  109.    flags will go to the screen.
  110.    
  111.    RENUMBER ERROR FLAGS
  112.         The error  flags  are  printed  whenever  a  variable  branch  or  a
  113.    unreferenced line number is encountered. the types of  error flags are as
  114.    follows:
  115.    
  116.    V/1000         The V indicates a variable branch and 1000 is the
  117.                     line number it occurs in.
  118.    
  119.    #/40000/1000   The # indicates a unreferenced line number, the 40000
  120.                     is the unknown line number and the 1000 is the line
  121.                     number it occurs in.
  122.    
  123.    DELETE
  124.         The DELETE  command will  delete  all line  numbers within  the  two
  125.    parameters.
  126.    
  127.    FORMAT:   DELETE strt [,END]
  128.    Short Hand: DEL.
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.    
  137.    PARAMETER  EXPLANATION
  138.    strt       Starting line number.
  139.    
  140.    end        Ending line number, the default is the starting line
  141.               number.
  142.    
  143.    EXAMPLES:
  144.    DELETE 10,100
  145.         Lines 10 thru 100 are deleted.
  146.    
  147.    DEL.20
  148.         Line 20 is deleted.
  149.    
  150.    REPLACE
  151.         The REPLACE command will replace a variable name with a new variable
  152.    name.
  153.    
  154.    FORMAT:   REPLACE "old-var","new-var"
  155.    Short Hand: REPL.
  156.    
  157.    PARAMETER  EXPLANATION
  158.    old-var    Old Variable Name, this must be a valid variable name.
  159.    
  160.    new-var    New Variable Name, this must be a valid variable name and
  161.               unique.
  162.    
  163.         If old-var  is a  string then  new-var must  be a  string. The  same
  164.    applies to array names. The  format of the variable name  is described in
  165.    the BASIC REFERENCE MANUAL.
  166.    
  167.    ERRORS RETURNED BY REPLACE
  168.    
  169.    ERROR CODE  EXPLANATION
  170.        22      Old Variable Name not found.
  171.        23      New Variable Name already exists.
  172.        24      Invalid Variable name.
  173.    
  174.    EXAMPLES:
  175.    REPLACE "A$","B$"
  176.        All occurences of A$ is  replaces with B$ and A$  is removed from the
  177.    Variable Name Table.
  178.    
  179.    REPL."ARRAY(","DARRY("
  180.        All occurences  of ARRAY(  is  replaces with  DARRAY( and  ARRAY(  is
  181.    removed from the Variable Name Table.
  182.    
  183.    REPLA."COUNTER","LCOUNT"
  184.        All occurences  of COUNTER  is replaces  with LCOUNT  and COUNTER  is
  185.    removed from the Variable Name Table.
  186.    
  187.    MARGIN
  188.         The MARGIN COMMAND automatically sets the left and right margins for
  189.    you.
  190.    
  191.    FORMAT:   MARGIN [left][,right]
  192.    Short Hand: MAR.
  193.    
  194.    PARAMETER EXPLANATION
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.    left      Left Margin, this must be greater than or equal to 0 and
  203.              less then 40. The default is 2.
  204.    
  205.    right     Right Margin, The must be greater than or equal to 0 and
  206.              less then 40. The default is 39.
  207.    
  208.    EXAMPLES:
  209.    
  210.    MAR.0,39
  211.         The margins  are set  to the  extreme left  and right  edges of  the
  212.    screen.
  213.    
  214.    MAR.
  215.         The margins are set as they are after System Reset.
  216.    
  217.    PART IV. DOS UTILITIES.
  218.    
  219.         Five Dos commands are included  in the Extended Basic program.  They
  220.    will allow the programmer limited file maintenence.
  221.    
  222.    ************* NOTE *****************
  223.    The DOS  command  has  been  disabled  for  the  reasons  of  giving  the
  224.    programmer the most  free memory,  and that DUP  will overwrite  Extended
  225.    Basic's memory. If you need to go to  DOS the following commands will get
  226.    you there.
  227.    
  228.    @X
  229.    DOS
  230.    
  231.    DIRECTORY
  232.         The DIRECTORY COMMAND  will print  the Directory  of a  Disk to  the
  233.    output device.
  234.    
  235.    FORMAT:   DIRECTORY [drive#][,output]
  236.    Short Hand: DI.
  237.    PARAMETER EXPLANATION
  238.    drive#    Disk Drive number the contains the disk you wish the
  239.              directory of, the default is drive 1.
  240.    
  241.    output    Device in which the printed output is to go valid devices
  242.              are E:,S:,P:. The default device is E:.
  243.    
  244.    EXAMPLES:
  245.    
  246.    DIR.
  247.         The directory of drive #1 is displayed on the screen.
  248.    
  249.    DIR.,"p:"
  250.         The directory of drive #1 is printed on the system printer.
  251.    
  252.    DIRECTORY 2
  253.         The directory of drive #2 is displayed on the screen.
  254.    
  255.    
  256.    LOCK, UNLOCK AND ERASE
  257.    
  258.    FORMAT: LOCK"D[n]:FILESPEC[.EXT]"
  259.         This command  will  lock  the  selected file,  or  files  that  meet
  260.    wildcard specs.
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.    
  269.    FORMAT: UNLOCK"D[n]:FILESPEC[.EXT]"
  270.         This command  will unlock  the  selected file,  or files  that  meet
  271.    wildcard specs.
  272.    
  273.    FORMAT: ERASE"D[n]:FILESPEC[.EXT]"
  274.         This command  will  erase the  selected  file,  or files  that  meet
  275.    wildcard specs.
  276.    
  277.    PARAMETER EXPLANATION
  278.    n         Drive number.
  279.    FILESPEC  Filename & optional Extension.
  280.    
  281.    RENAME
  282.         This command will rename a file with a new file name.
  283.    
  284.    FORMAT: RE